home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / cpack.z / cpack
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ccccppppaaaacccckkkk((((3333GGGG))))                                                            ccccppppaaaacccckkkk((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ccccppppaaaacccckkkk - specifies RGBA color with a single packed 32-bit integer
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ccccppppaaaacccckkkk((((ppppaaaacccckkkk))))
  13.      uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg ppppaaaacccckkkk;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_a_c_k   expects a packed integer containing the RGBA (red, green, blue,
  17.             alpha) values you want to assign as the current color. Expressed
  18.             in hexadecimal, the format of the packed integer is 0x_a_a_b_b_g_g_r_r,
  19.             where:
  20.  
  21.                _a_a   is the alpha value,
  22.                _b_b   is the blue value,
  23.                _g_g   is the green value, and
  24.                _r_r   is the red value.
  25.  
  26.             RGBA component values range from 0 to 0xFF (255).
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ccccppppaaaacccckkkk sets the red, green, blue, and alpha color components of the
  30.      currently active GL framebuffer, one of normal, popup, overlay, or
  31.      underlay (see ddddrrrraaaawwwwmmmmooooddddeeee).  The current framebuffer must be in RGB mode
  32.      (see RRRRGGGGBBBBmmmmooooddddeeee) for the ccccppppaaaacccckkkk command to be applicable.  Most drawing
  33.      commands copy the current RGBA color components into the color bitplanes
  34.      of the current framebuffer.  Color components are retained in each draw
  35.      mode, so when a draw mode is re-entered, red, green, blue, and alpha are
  36.      reset to the last value specified in that draw mode.
  37.  
  38.      Color component values range from 0, specifying no intensity, through
  39.      255, specifying maximum intensity.  For example, ccccppppaaaacccckkkk((((0000xxxxFFFFFFFF000000004444000088880000)))) sets
  40.      red to 0x80 (half intensity), green to 0x40 (quarter intensity), blue to
  41.      0 (off), and alpha to 0xFF (full intensity).
  42.  
  43.      It is an error to call ccccppppaaaacccckkkk while the current framebuffer is in color
  44.      map mode.
  45.  
  46.      The color components of all framebuffers in RGB mode are set to zero when
  47.      ggggccccoooonnnnffffiiiigggg is called.
  48.  
  49. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  50.      c, drawmode, gRGBcolor, lmcolor
  51.  
  52. NNNNOOOOTTTTEEEE
  53.      ccccppppaaaacccckkkk can also be used to modify the current material while lighting is
  54.      active (see llllmmmmccccoooolllloooorrrr).
  55.  
  56.      Because only the normal framebuffer currently supports RGB mode, ccccppppaaaacccckkkk
  57.      should be called only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.  Use ggggeeeettttggggddddeeeesssscccc to
  58.      determine whether RGB mode is available in draw mode NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.